home *** CD-ROM | disk | FTP | other *** search
/ Developer CD Series 1998 May: Tool Chest / Dev.CD May 98 TC.toast / Tool Chest / OS Utilities / Gestalt Selectors List 4.1 / Updates / GSL Update 4.0.2 < prev    next >
Encoding:
Text File  |  1997-11-29  |  15.0 KB  |  443 lines  |  [TEXT/R*ch]
  1.  
  2.  
  3. Hello,
  4.  
  5. Here is the new GSL update with many new selectors and changes. See
  6. below.
  7. Also, a new version (2.7.8) of Gestalt.Appl is available from the
  8. GSL web page at
  9.     http://www.bio.vu.nl/home/rgaros/gestalt/
  10.  
  11. The GSL is now member of the MacDev Webring. See this URL for more:
  12.     http://www.webring.org/cgi-bin/webring?home;ring=macdev
  13.  
  14. 'till next time!
  15.  
  16. René
  17.  
  18.  
  19. Gestalt Selectors List 4.0.2 Update
  20. ===================================
  21.  
  22. Maintained and published by Rene G.A. Ros (rgaros@bio.vu.nl)
  23.  
  24. First published: 12 October 1992, 13:15 CET (GMT+1)
  25. Last version   : 12 October 1997, 14:15 CET (GMT+2, DST)
  26. Previous update:  2 November 1997, 22:50 CET (GMT+1)
  27. Last modified  : 29 November 1997, 16:10 CET (GMT+1)
  28.  
  29. The complete version is available to subscribers by sending an email to:
  30.      gestalt-selectors-list-request@bio.vu.nl
  31. with as subject:
  32.      archive get recent/gestalt-selectors.etx
  33. or to get the compressed version:
  34.      archive get recent/gestalt-selectors.sit.hqx
  35. The latest GSL version is also available on the GSL Web page. Point your
  36. Internet browser to:
  37.      http://www.bio.vu.nl/home/rgaros/gestalt/
  38.  
  39. If this is the first update you receive since subscribing to the mailing
  40. list you may want to get the previous updates as well. Then email to the
  41. address listed above and use this command:
  42.      archive get updates/updates-comb.etx
  43.  
  44. A vertical bar in front of a line indicates the line has changed or was
  45. added.
  46.  
  47. PLEASE SEND COMMENTS AND CORRECTIONS TO THE EDITOR AS SOON AS POSSIBLE.
  48.  
  49. The following persons contributed to this update:
  50.  
  51. ===========================================================================
  52. Contributions to the selector sections
  53. ===========================================================================
  54. Person                 Software                Selector(s) added/changed
  55. ---------------------------------------------------------------------------
  56. Anonymous 1            Mac OS 8.1              adbr, dtpf, vm  
  57.                        AppleShare IP 5.0       asdg, asra, asrs
  58. Anonymous 2            unknown, Mac OS 8.1 &   cspX, FPPn, fPPP, OKEY,
  59.                         misc.                  PVTL, rpPL, sdDB, sdNL,
  60.                                                spDE, spDe, YSMT
  61. Anonymous 3            Open Transport          otvr
  62. Lars Christensen       Speech cp               TkAl
  63. Chuck Crannel          unknown                 kDEF, NWFS
  64. Rene Ros               AppleShare ext          afps
  65.                        BlackWatch app          SAVC, SAVR
  66.                        System                  bclk, pclk
  67.                        WebFree cp              wFRE
  68.                        unknown                 SCb1, Srdp, Ssdk
  69. ---------------------------------------------------------------------------
  70.  
  71. Apple System Software (A-D)
  72. ===========================
  73. |afps (AppleShare ext [3.5?], part of System 7.5) &AD18, &AT20
  74. |     gestaltAppleShareClientVersion?
  75. |     Returns the version of the AppleShare client software as integer in
  76. |     the low-word of the response. The high-word of the response returns
  77. |     unknown information. (Rene Ros)
  78. |
  79. |     enum {
  80. |     #define gestaltAppleShareClientVersion? 'afps'
  81. |     gestaltAppleShareVersionMask? = 0x0000FFFF}; /* Version is in lower
  82. |                                                     2 bytes of result */
  83. |     const   short   kASver_3_5      = 1;
  84. |     const   short   kASver_3_6      = 2;
  85. |     const   short   kASver_3_6_1    = 3;
  86. |     const   short   kASver_3_6_2    = 4;
  87. |     const   short   kASver_3_6_3    = 5;    // incld. 3.6.3, 3.6.4, 3.6.5
  88. |     const   short   kASver_3_7      = 6;    // incld. 3.7.1
  89. |     const   short   kASver_3_7_2    = 7;
  90.  
  91.  bclk (System [7.5.2?) INF?
  92.       gestaltBusClkSpeed &AS22
  93.       Returns the main I/O bus clock speed in Hz.
  94.  
  95.       #define gestaltBusClkSpeed 'bclk'
  96.  
  97.       NOTES:
  98.       Only on Power Macintosh, not on 68K computers?
  99.  
  100.       Some 604-based Power Computing models return the wrong value.
  101.  
  102.       A Daystar Genesis MP (4x 604e at 200 MHz each) returns a value of
  103.       50 MHz. There is no sign of a selector which returns the number of
  104.       processors.
  105.  
  106.       The Pippin has been observed to return the value for 66 MHz, which
  107.       is equal to its processor clock speed. This value is probably
  108.       incorrect.
  109.  
  110. |     A Power Macintosh 700 (PPC upgraded Quadra 700) using System 7.5.5
  111. |     returns 2 MHz. The 'pclk' value is also incorrect.
  112.  
  113.       See also 'pclk' in this chapter.
  114.  
  115. Apple System Software (E-H)
  116. ===========================
  117. No changes.
  118.  
  119. Apple System Software (I-L)
  120. ===========================
  121. No changes.
  122.  
  123. Apple System Software (M)
  124. =========================
  125. No changes.
  126.  
  127. Apple System Software (N-O)
  128. ===========================
  129.  otvr (Open Transport lib [1.1])
  130. |     gestaltOpenTptVersion?
  131.       Returns the version of Open Transport as NumVersion. (Anonymous)
  132.  
  133.       enum {
  134. |     #define gestaltOpenTptVersion? 'otvr'
  135.  
  136. |     kOTIPSingleLinkMultihomingVersion = 0x01300000    /* OT 1.3 */
  137.       }
  138.  
  139. Apple System Software (P-S)
  140. ===========================
  141.  pclk (System [7.5.2]) INF?
  142.       gestaltProcClkSpeed &AS22
  143.       Returns the processor clock speed in Hz.
  144.  
  145.       #define gestaltProcClkSpeed 'pclk'
  146.  
  147.       NOTES:
  148.       Only on Power Macintosh, not on 68K computers?
  149.  
  150.       On a PowerBook 5300c with System 7.5.2 this selector returns 99.9999 Mhz,
  151.       not 100. Small 'off-by-one' bug? (Rene Ros)
  152.  
  153.       Some 604-based Power Computing models return the wrong value. This may
  154.       be because the ROM doesn't properly handle speeds above 200 MHz.
  155.       (Jean-Pierre Curcio and others)
  156.  
  157. |     A Power Macintosh 700 (PPC upgraded Quadra 700) using System 7.5.5
  158. |     returns 5 MHz. The 'bclk' value is also incorrect.
  159.  
  160.       A Daystar Genesis MP (4x 604e at 200 MHz each) returns a value of
  161.       200 MHz. There is no sign of a selector which returns the number of
  162.       processors.
  163.  
  164.       Mac OS in the Blue Box under Rhapsody returns a value for 80 MHz.
  165.       (Anonymous)
  166.  
  167.       See also 'bclk' in this chapter.
  168.  
  169.  shut (System? [7.6?])
  170.       gestaltShutdownAttributes
  171.       Returns information about the ShutDown Manager.
  172.  
  173.       enum {
  174.       #define gestaltShutdownAttributes 'shut'
  175.                                            /* ShutDown Manager Attributes */
  176.       gestaltShutdownHassdOnBootVolUnmount = 0,  /* True if ShutDown Manager
  177.                                                     unmounts boot & VM
  178.                                                     volume at shutdown
  179.                                                     time. &AS28 */
  180. |     gestalt???                           = 1}; /* unknown, Mac OS 8*/
  181.  
  182. Apple System Software (T-Z)
  183. ===========================
  184.  vm   (System [6.0.4])
  185.       gestaltVMAttr
  186.       Returns information about virtual memory.
  187.  
  188.       enum {
  189.       #define gestaltVMAttr 'vm  '
  190.       gestaltVMPresent       = 0,  /* set; virtual memory present */
  191.       gestaltVMNotInstalled  = 0,  /* clear; virtual memory not present */
  192.       gestaltVMHasLockMemoryForOutput = 1,
  193.                                    /* LockMemoryForOutput available */
  194.       gestalt???             = 2,  /* unknown, Mac OS 7.6? */
  195.       gestaltVMFilemappingOn = 3,  /* Filemapping is available
  196.                                       (Mac OS 7.6?) &AS28 */
  197. |     gestalt???             = 4}; /* unknown, seen with Mac OS 8.1 beta */
  198.  
  199.       NOTE:
  200.       Starting with Copland (abandoned Mac OS 8) is always on but this
  201.       selector will tell VM is off. A future selector allows to test if
  202.       the microkernel is running and thus if VM is actually used.
  203.       &AD10/AD22
  204.  
  205.       With Rhapsody's Blue Box the note above is true and real. See for
  206.       more info the 'lram' selector. (Anonymous)
  207.  
  208. Apple Additional Software
  209. =========================
  210. No changes.
  211.  
  212. Third Parties Software
  213. ======================
  214.  SAVC (AfterDark cp [2.0] by Berkeley Systems, Inc.)
  215.       (Basic Black cp [1.3.3] by Mason L. Bliss)
  216. |     (BlackWatch app [1.0] by Ken McLoad)
  217.       (CDU cp [1.0?] by Connectix Corp.)
  218.       (DarkSide of the Macintosh [4.0] by Tom Dowdy)
  219.       (PixelPlay? ??? [???] by ???)
  220.       (ScreenDaemon ??? [1.0] by Mason L. Bliss)
  221.       (Sleeper cp [1.1.4?] by St.Clair Software)
  222.       gestaltScreenSaverControl &M05
  223.       Returns a pointer to a routine of type
  224.  
  225.       typedef pascal OSErr (*SaverControlProcPtr) (SaverCommand command);
  226.  
  227.       which allows controlling the screen saver.
  228.  
  229.       #define gestaltScreenSaverControl 'SAVC'
  230.  
  231.       NOTE:
  232.       See for more information the AfterDark Gestalt header file. It
  233.       is available by sending email to
  234.       gestalt-selectors-list-request@bio.vu.nl using the command
  235.       'archive get src/AfterDarkGestalt.h'
  236.       Or by emailing to Berkeley Systems Mac Tech Support at
  237.       brklysystm@aol.com and ask them for the AfterDarkGestalt.h file.
  238.  
  239.  SAVR (AfterDark cp [2.0] by Berkeley Systems, Inc.)
  240.       (Arashi app [???] by Juri Munkki)
  241. |     (Basic Black cp [1.3.3] by Mason L. Bliss)
  242.       (BlackWatch app [1.0] by Ken McLoad)
  243.       (CDU cp [1.0?] by Connectix Corp.)
  244.       (Coffee Break app [1.0] by Thomas Reed)
  245.       (DarkSide of the Macintosh [4.0] by Tom Dowdy)
  246.       (PixelPlay? ??? [???] by ???)
  247.       (ScreenDaemon ??? [1.0] by Mason L. Bliss)
  248.       (Sleeper cp [1.1.4?] by St.Clair Software)
  249.       gestaltScreenSaverAttr &M05
  250.       Returns information about the current screen saver. Defined if a
  251.       screen saver is installed.
  252.  
  253.       enum {
  254.       #define gestaltScreenSaverAttr 'SAVR' /* Screen saver attributes */
  255.       gestaltSaverTurnedOn      = 0,  /* saver enabled/disabled */
  256.       gestaltSaverAsleep        = 1,  /* saver currently asleep */
  257.       gestaltSaverDemoMode      = 2,  /* saver sleeping in demo mode */
  258.       gestaltSaverPasswordMode  = 3,  /* saver sleeping in password-
  259.                                           protected mode */
  260.       gestaltAppDrawingDisabled = 4}; /* QD drawing disallowed between
  261.                                           module animation frames */
  262.  
  263.       NOTE:
  264.       See for more information the AfterDark Gestalt header file. It
  265.       is available by sending email to
  266.       gestalt-selectors-list-request@bio.vu.nl using the command
  267.       'archive get src/AfterDarkGestalt.h'
  268.       Or by emailing to Berkeley Systems Mac Tech Support at
  269.       brklysystm@aol.com and ask them for the AfterDarkGestalt.h file.
  270.  
  271.       Thomas Reed wrote some source code (C) demonstrating how to install
  272.       this selector. You can get a copy by sending email to
  273.       gestalt-selectors-list-request@bio.vu.nl using the command
  274.       'archive get src/gestalt-savr.txt'
  275.  
  276. Unknown Apple Software (A-K)
  277. ============================
  278. |adbr (System [8.1?])
  279. |asdg (AppleShare IP Registry ext [5.0.2?] part of AppleShare IP 5.0)
  280. |asra (AppleShare IP Registry ext [5.0.2?] part of AppleShare IP 5.0)
  281. |asrs (AppleShare IP Registry ext [5.0.2?] part of AppleShare IP 5.0)
  282. |dtpf (System? [8.1?])
  283. |     Desktop Printing features?
  284. |     Observed: 3
  285.  
  286. Unknown Apple Software (L-Z)
  287. ============================
  288. |ptsm (System? [8.0?])
  289. |TkAl (Speech cp [1.5?] SpeakAlerts INIT resource, part of English
  290. |      Text-to-Speech 1.5?)
  291.  
  292. Unknown Third Parties Software
  293. ==============================
  294. |cspX (FinderPop cp [???] by turly@geocities.com)
  295. |FPPn (??? [???])
  296. |     Installed by Mac OS 8.1?
  297. |
  298. |     NOTE: The n is actually the option-n/n character (0x96).
  299. |fPPP (FreePPP cp [2.62b1?])
  300. |kDEF (??? [???])
  301. |NWFS (??? [???])
  302. |OKEY (OkeyDokey Pro cp [???])
  303. |PVTL (??? [???])
  304. |     Installed by Mac OS 8.1?
  305. |
  306. |rpPL (??? [???])
  307. |SCb1 (??? [???])
  308. |sdDB (??? [???])
  309. |     Installed by Mac OS 8.1?
  310. |
  311. |sdNL (??? [???])
  312. |spDE (Speed Doubler [8.0?])
  313. |spDe (Speed Doubler [8.0?])
  314. |Srdp (??? [???])
  315. |Ssdk (??? [???])
  316. |wFRE (WebFree cp [1.1?] by Steve Falkenburg)
  317. |YSMT (??? [???])
  318. |     Installed by Mac OS 8.1?
  319.  
  320. Reports
  321. =======
  322. No changes.
  323.  
  324. General Info
  325. ============
  326.  
  327. Sources
  328. -------
  329. A    Apple Computer, Inc.
  330. AT    Technical Notes
  331. AT20   TN 1111 - Programmatic Mounting of AppleShare Volumes, October 1997
  332.  
  333. About this list
  334. ===============
  335. For this update this chapter only includes the 'Gestalt Submission Form',
  336. 'Acknowledgements' and 'Editors' Address' sections.
  337.  
  338. Gestalt Submission Form
  339. -----------------------
  340. You can use this form to report information you found on already included
  341. selectors. But you can also use it to register new Gestalt selector codes.
  342. If you want to register the selector code your software installs, make sure
  343. you registered your code first with Apple Computer, Inc. Also, it is your
  344. good right if you chose to keep the meaning of the response value private.
  345. If so, still register so that others can at least detect your software by
  346. determining if the selector is present.
  347.  
  348. Software means, in this form, the software which installs the selector
  349. code. Not the whole package, just the extension or control panel (perhaps
  350. application) itself.
  351. The package is the product name in which the software is included and
  352. distributed.
  353. If data is not available or relevant, leave it blank. When the selector
  354. contains non-ASCII characters, please also provide the hexadecimal value.
  355.  
  356. You can also fill in this form on-line because it is also on the WWW
  357. pages of the GSL: http://www.bio.vu.nl/home/rgaros/gestalt/
  358.  
  359.  
  360. Your name: 
  361.  
  362. Your email address: 
  363.  
  364. Your company name: 
  365.  
  366. Do you want to remain anonymous? Yes / No
  367.  
  368. Category:      O Apple System Software
  369.                O Apple Additional Software
  370.                O Apple Software
  371.                O Third Parties Software
  372.  
  373. Gestalt Selector: 
  374.  
  375. Software name: 
  376.  
  377. Software type: O application 
  378.                O control panel
  379.                O extension (also 'appe')
  380.                O other:
  381.  
  382. First version to install selector: 
  383.  
  384. Package name: 
  385.  
  386. Author or Company name: 
  387.  
  388. Constant name: 
  389.  
  390. Source of information: 
  391.  
  392. Short description of the returned response:
  393.  
  394.  
  395.  
  396.  
  397.  
  398. Additional constant names and values for the response value meaning:
  399.  
  400.  
  401.  
  402.  
  403.  
  404. Please email this form to this Internet address: rgaros@bio.vu.nl
  405.  
  406. Acknowledgements
  407. ----------------
  408. I want to thank the following persons for their contributions to this
  409. update and their support of this list:
  410.  
  411. ===========================================================================
  412. Name                                       Internet Email Address
  413. ---------------------------------------------------------------------------
  414. Anonymous contributor(s)                   anonymous@secret.bvd.nl
  415. Lars Christensen                           elenzee@hotmail.com
  416. Chuck Crannell                             chuck_crannell@baynetworks.com
  417. Jean-Pierre Curcio                         jpc83@calva.net
  418. Hans Dorland
  419. ---------------------------------------------------------------------------
  420.  
  421. Legal Stuff
  422. -----------
  423. (C) 1992-1997, Rene G.A. Ros
  424.  
  425. It is not allowed to distribute the GSL updates separate from the full GSL.
  426. The full GSL can be used freely but is not public domain.
  427. See for legal information the Legal Stuff chapter of the full Gestalt
  428. Selectors List.
  429.  
  430. Editor's Address
  431. ----------------
  432. Rene G.A. Ros
  433. Developer and consultant at S&B Office Services, Woerden, The Netherlands
  434. Consultant to the Computer Department,
  435.     Biology Faculty, Vrije Universiteit Amsterdam, The Netherlands.
  436.  
  437. Email: rgaros@bio.vu.nl (preferred)
  438.        rene_ros@office.nl (work)
  439.        rgaros@dds.nl
  440.        100112.1363@compuserve.com
  441. WWW  : http://www.bio.vu.nl/home/rgaros/
  442.        http://huizen.dds.nl/~rgaros
  443.